jaga 

3E^|Tgj 


OS/2 TCP/IP Installation 
(INSTALL.EXE) 


George McMullen 
Barry Myers 

T/L 444-9702 or 441-2871 
georgemc @ rptnotes or bamyers @ rtpnotes 





Terminology 



•ZIP - The TCP/IP packaging groups code 
using INFOZIP's PKZIP format. 

•EXITS - A TCP/IP exit is simply an executable 
piece of code that gets called to perform a 
certain task to complete installation. 

•IFOLDER - The utility that TCP/IP's 
installation program calls to populate the 
desktop with icons. 



Overview 



•Descriptions 

/The TCP/IP install code in WARP 
V4 (INSTALL.EXE) will install the 
TCP/IP applications. This program 
uses UNZIP to place most of the 
files and uses code exits to gather 
information to complete the 
installation. 

/ The TCP/IP uninstall code 
(UINSTALL.EXE) will remove the 
TCP/IP program files and their 
configuration files from the 
machine. 

/The program that is used by both 
install and uninstall programs to 
add or remove ICONs from the 
desktop is the IFOLDER.EXE 
program. 



Overview - 
New Features 



•Supported 

/CID install documentation and code were 
cleaned up significantly. Errors (both syntax 
and invalid keyword combinations) are now 
detected, logged and will return a return code. 

/Additional CID support was added to the 
install to allow configuration of: 

-up to 9 LAN adapters. 

-up to 3 Nameservers. 

/PCOMM Lite replaced TN3270 and TN5250 
support. 

/UNINSTALL support was added. 

/Install of Software Updates function was 
added. 

/Many changes were made to FOLDER 
(populate the desktop) utility. 

/The installation code will now do Syslevel 
checking to validate the compatibility 
problems before we install our code. 



Overview - Features 
Cont... 



•Unsupported 

/TN3270 no longer installed. 
/TN5250 no longer installed. 
/PMANT no longer installed. 
/TELNETO no longer installed. 
/SNMP is now part of System View. 



New Features 



/PCOMM install 

-Done mostly with the UNZIPPING of 
PCOM1.ZIP through PCOM4.ZIP. 

-There is a PCOMXT.EXE file that builds a 
PCSOS2.INI file and places it into the \OS2 
directory. This is used by PCOMM full pack 
to know what level of code is currently 
installed on the system. 

/UNINSTALL 

-This function is the INSTALL.EXE 
recompiled with the UNINSTALL flag on. 

-Most of the function is done using the 
tables that are defined in the TCPUNINS.H 
file. 

-The rest of the uninstall function is spread 
throughout the install code. 

/IFOLDER 

-The /C parameter was added to the 
IFOLDER.EXE to destroy all TCP/IP icons 
and their settings. (USED by 
UINSTALL.EXE.) 




Limitations & 
Dependencies 


•Warp Connect V4 TCP/IP requires 
Warp Connect V4 or higher. 

•Warp Connect V4 TCP/IP requires 
MPTS version 5.1 or higher. 

•There is NO code to prevent the 
installation of Warp Connect V4 
TCP/IP over Warp Server SMP V4 
clients, however this is NOT a 
supported configuration. TCP/IP 
V3.5 is intended to be used with 
Warp Server SMP workstations. 



Invocation & Startup 



•The INSTALL.EXE will most of the 
time be invoked by OS/2 TOP install 
with a CID response file. 

/With OS/2. 

/With Selective Install. 

•Other possible installation 
invocations are: 

/Install from diskettes. 

/Install with CID response files. 

•The UINSTALL.EXE (TCP/IP's 
uninstall) may be invoked by clicking 
on an icon or the command may be 
typed on an OS/2 command line. 

The invocation is documented in the 
TCP/IP reference. 

•The IFOLDER.EXE is only run by the 
install and uninstall programs but is 
available to be run on the command 
line if needed. 



Error Messages, Codes 
& Logs 



•All messages can be found in the 
tcpinst.msg file in the \enus 
directory of the CMVC library. 
Documentation for the error 
messages is in the TCP/IP reference. 

•ERROR LOGGING 

/TCP/IP install ALWAYS logs 
information when it runs. 

/The log if invoked by TOP install is 
located in \ibminst\logs\tcpapps 
directory and is called local.tcp. 

/If TCPIP install is run by itself it 
always puts it into the root of the 
boot drive. (In most cases C:\) and 
the log file name is called 

tcpip.log. 



Common User 
Problems 



•Most "common" user errors were 
related to CID installation in the past 
hopefully this will not be as big of a 
problem in Warp Connect V4 since 
this area was given a good bit of 
focus. The documentation and code 
has been significantly improved. 



Problems that users 
may have in Warp V4 



•The following problems have been 
identified to Warp development and 
may appear to be defects with 


INSTALL but are NOT. 

/The Warp V4 desktop will cause 
many previous users problems. 

-Icons are moved/hidden. 

-Old Icons that are not migrated 
are moved to the OLD desktop 
Icon. 

-Many users complaints during 
Beta. 

/URL ICONs do not work unless you 
configure them. These icons use 
their own INI file to hold 
configuration information and they 
launch a web browser. If you have 
a working Webexplore web browser 
and click on a URL ICON it may not 
work because it may not be 
configured properly in the URL 
ICON. 

-The GET Netscape ICON on the 
desktop is a perfect example of 
this. 



Debugging & 
Troubleshooting 



•Your best bet for debug information is 
to check the error log file that we 
create. 

(\ibminst\logs\tcpapps\local.tcp) 

•If the problem is CID related then get 
the CID response file that was being 
used to determine what the error may 
have been. 

•Use IPMD debugger for the more 
difficult problems. Dummy up a ZIP 
file that contains not much of 
anything to run your tests with. 




Source and Reference 
material 


•All Source Code is in CMVC. 

/family = wstcp 
/component = os2installc 

•release = os2apps32 or 
os2apps32nls Design documentation 
is in CMVC 

/ family = wstcp 
/component = os2design 
•release = os2apps32 



